Inside Macintosh: QuickTime Components

| Previous | Chapter contents | Chapter top | Section top |

Summary of Movie Data Exchange Components

C Summary

Constants

/* component type values */
#define MovieImportType 'eat '                  /* movie data import */
#define MovieExportType 'spit'                  /* movie data export */
 /*&nsp; componentFlags values for movie import and movie export components */
enum {
    canMovieImportHandles                   = 1,    /* can import from handles */
    canMovieImportFiles                     = 2,    /* can import from files */
    hasMovieImportUserInterface             = 4,    /* import has user interface */
    canMovieExportHandles                   = 8,    /* can export to handles */
    canMovieExportFiles                     = 16,   /* can export to files */
    hasMovieExportUserInterface             = 32,   /* export has user interface */
    dontAutoFileMovieImport                 = 64    /* do not automatically import
                                                        movie files */
};
 /*  flags for MovieImportHandle and MovieImportFile */
enum {
    movieImportCreateTrack                  = 1,    /* create a new track */
    movieImportInParallel                   = 2,    /* paste imported data */
    movieImportMustUseTrack                 = 4     /* use specified track */
};
 enum {
    movieImportResultUsedMultipleTracks = 8,                /* component used several
                                                                tracks */
};
 enum {
    /* movie data import components */
    kMovieImportHandleSelect                            = 1,    /* import from handle */
    kMovieImportFileSelect                              = 2,    /* import from file */
    kMovieImportSetSampleDurationSelect                 = 3,    /* set sample duration */
    kMovieImportSetSampleDescriptionSelect = 4,                 /* set sample description */
    kMovieImportSetMediaFileSelect                      = 5,    /* set media file */
    kMovieImportSetDimensionsSelect                     = 6,    /* set track dimensions */
    kMovieImportSetChunkSizeSelect                      = 7,    /* set chunk size */
    kMovieImportSetProgressProcSelect                   = 8,    /* set progress func */
    kMovieImportSetAuxiliaryDataSelect                  = 9,    /* set additional data */
    kMovieImportSetFromScrapSelect                      = 10,   /* data from scrap */
    kMovieImportDoUserDialogSelect                      = 11,   /* invoke user dialog */
    kMovieImportSetDurationSelect                       = 12    /* set paste duration */
    
    /* movie data export components */
    kMovieExportToHandleSelect                      = 128,  /* export to handle */
    kMovieExportToFileSelect                        = 129,  /* export to file */
    kMovieExportDoUserDialogSelect                  = 130,  /* invoke user dialog */
    kMovieExportGetAuxiliaryDataSelect              = 131,/* get additional data */
    kMovieExportSetProgressProcSelect               = 132   /* set progress function */
};

Data Type

typedef ComponentInstance MovieImportComponent, MovieExportComponent;

Functions

Importing Movie Data
pascal ComponentResult MovieImportHandle
(MovieImportComponent ci, Handle dataH, Movie theMovie, Track targetTrack, Track *usedTrack, TimeValue atTime, TimeValue *addedDuration, long inFlags, long *outFlags);
 pascal ComponentResult MovieImportFile
(MovieImportComponent ci, const FSSpec *theFile, Movie theMovie, Track targetTrack, Track *usedTrack, TimeValue atTime, TimeValue *addedDuration, long inFlags, long *outFlags);
Configuring Movie Data Import Components
pascal ComponentResult MovieImportSetDuration
(MovieImportComponent ci, TimeValue duration);
 pascal ComponentResult MovieImportSetSampleDuration
(MovieImportComponent ci, TimeValue duration, TimeScale scale);
 pascal ComponentResult MovieImportSetSampleDescription
(MovieImportComponent ci, SampleDescriptionHandle desc, OSType mediaType);
 pascal ComponentResult MovieImportSetMediaFile
(MovieImportComponent ci, AliasHandle alias);
 pascal ComponentResult MovieImportSetDimensions
(MovieImportComponent ci, Fixed width, Fixed height);
 pascal ComponentResult MovieImportSetChunkSize
(MovieImportComponent ci, long chunkSize);
 pascal ComponentResult MovieImportSetProgressProc
(MovieImportComponent ci, MovieProgressUPP proc, long refcon);
 pascal ComponentResult MovieImportSetAuxiliaryData
(MovieImportComponent ci, Handle data, OSType handleType);
 pascal ComponentResult MovieImportSetFromScrap
(MovieImportComponent ci, Boolean fromScrap);
 pascal ComponentResult MovieImportDoUserDialog
(MovieImportComponent ci, const FSSpec *theFile, Handle theData, Boolean *canceled);
Exporting Movie Data
pascal ComponentResult MovieExportToHandle
(MovieImportComponent ci, Handle dataH, Movie theMovie, Track onlyThisTrack, TimeValue startTime, TimeValue duration);
 pascal ComponentResult MovieExportToFile
(MovieImportComponent ci, const FSSpec *theFile, Movie theMovie, Track onlyThisTrack, TimeValue startTime, TimeValue duration);
Configuring Movie Data Export Components
pascal ComponentResult MovieExportSetProgressProc
(MovieImportComponent ci, MovieProgressUPP proc, long refcon);
 pascal ComponentResult MovieExportGetAuxiliaryData
(MovieImportComponent ci, Handle dataH, OSType *handleType);
 pascal ComponentResult MovieExportDoUserDialog
(MovieImportComponent ci, const FSSpec *theFile, Handle theData, Boolean *canceled);

Result Codes

invalidTrack

-2009

Specified track cannot receive imported data

unsupportedAuxiliaryImportData

-2057

Cannot work with specified handle type

badComponentSelector

0x80008002

Function not supported

Pascal Summary

Constants

CONST
{component type values}
    MovieImportType = 'eat '                    {movie data import}
    MovieExportType = 'spit'                    {movie data export}

{componentFlags values for movie import and movie export components}
    canMovieImportHandles                   = 1;    {can import from handles}
    canMovieImportFiles                     = 2;    {can import from files}
    hasMovieImportUserInterface             = 4;    {import has user interface}
    canMovieExportHandles                   = 8;    {can export to handles}
    canMovieExportFiles                     = $10;  {can export to files}
    hasMovieExportUserInterface             = $20;{export has user interface}
    dontAutoFileMovieImport                 = $40;{do not automatically import movie }
                                                    { files}
 {flags for MovieImportHandle and MovieImportFile functions}
    movieImportCreateTrack                          = 1;    {create a new track}
    movieImportInParallel                           = 2;    {paste imported data}
    movieImportMustUseTrack                         = 4;    {use specified track}
    movieImportResultUsedMultipleTracks = 8;                {component used several }
                                                            { tracks}
 {movie data import components}
    kMovieImportHandleSelect                            = 1;    {import from handle}
    kMovieImportFileSelect                              = 2;    {import from file}
    kMovieImportSetSampleDurationSelect                 = 3;    {set sample duration}
    kMovieImportSetSampleDescriptionSelect = 4;                 {set sample description}
    kMovieImportSetMediaFileSelect                      = 5;    {set media file}
    kMovieImportSetDimensionsSelect                     = 6;    {set track dimensions}
    kMovieImportSetChunkSizeSelect                      = 7;    {set chunk size}
    kMovieImportSetProgressProcSelect                   = 8;    {set progress function}
    kMovieImportSetAuxiliaryDataSelect                  = 9;    {set additional data}
    kMovieImportSetFromScrapSelect                      = $A;   {data from scrap}
    kMovieImportDoUserDialogSelect                      = $B;   {invoke user dialog box}
    kMovieImportSetDurationSelect                       = $C;   {set paste duration}
     {movie data export components}
    kMovieExportToHandleSelect                      = $80;      {export to handle}
    kMovieExportToFileSelect                        = $81;      {export to file}
    kMovieExportDoUserDialogSelect                  = $82;      {invoke user dialog box}
    kMovieExportGetAuxiliaryDataSelect              = $83;      {get additional data}
    kMovieExportSetProgressProcSelect               = $84;      {set progress function}

Data Type

TYPE
     MovieImportComponent = ComponentInstance;
    MovieExportComponent = ComponentInstance;

Routines

Importing Movie Data
FUNCTION MovieImportHandle (ci: MovieImportComponent; dataH: Handle; theMovie: Movie; targetTrack: Track; VAR usedTrack: Track; atTime: TimeValue; VAR addedDuration: TimeValue; inFlags: LongInt; VAR outFlags: LongInt): ComponentResult;
 FUNCTION MovieImportFile (ci: MovieImportComponent; theFile: FSSpec; theMovie: Movie; targetTrack: Track; VAR usedTrack: Track; atTime: TimeValue; VAR addedDuration: TimeValue; inFlags: LongInt; VAR outFlags: LongInt): ComponentResult;
Configuring Movie Data Import Components
FUNCTION MovieImportSetDuration
 (ci: MovieImportComponent; duration: TimeValue): ComponentResult;
 FUNCTION MovieImportSetSampleDuration
 (ci: MovieImportComponent; duration: TimeValue; scale: TimeScale): ComponentResult;
 FUNCTION MovieImportSetSampleDescription
 (ci: MovieImportComponent; desc: SampleDescriptionHandle; mediaType: OSType): ComponentResult;
 FUNCTION MovieImportSetMediaFile
 (ci: MovieImportComponent; alias: AliasHandle): ComponentResult;
 FUNCTION MovieImportSetDimensions
 (ci: MovieImportComponent; width, height: Fixed): ComponentResult;
 FUNCTION MovieImportSetChunkSize
 (ci: MovieImportComponent; chunkSize: LongInt): ComponentResult;
 FUNCTION MovieImportSetProgressProc
 (ci: MovieImportComponent; proc: ProcPtr; refCon: LongInt): ComponentResult;
 FUNCTION MovieImportSetAuxiliaryData
 (ci: MovieImportComponent; data: Handle; handleType: OSType): ComponentResult;
 FUNCTION MovieImportSetFromScrap
 (ci: MovieImportComponent; fromScrap: Boolean): ComponentResult;
 FUNCTION MovieImportDoUserDialog
 (ci: MovieImportComponent; srcFile: FSSpec; data: Handle; VAR canceled: Boolean): ComponentResult;
Exporting Movie Data
FUNCTION MovieExportToHandle
(ci: MovieExportComponent; data: Handle; theMovie: Movie; onlyThisTrack: Track; startTime: TimeValue; duration: TimeValue): ComponentResult;
 FUNCTION MovieExportToFile (ci: MovieExportComponent; dstFile: FSSpec; theMovie: Movie; onlyThisTrack: Track; startTime: TimeValue; duration: TimeValue): ComponentResult;
Configuring Movie Data Export Components
FUNCTION MovieExportSetProgressProc
 (ci: MovieExportComponent; proc: ProcPtr; refCon: LongInt): ComponentResult;
 FUNCTION MovieExportGetAuxiliaryData
 (ci: MovieExportComponent; dstFile: Handle; VAR handleType: OSType): ComponentResult;
 FUNCTION MovieExportDoUserDialog
 (ci: MovieExportComponent; dstFile: FSSpec; data: Handle; VAR canceled: Boolean): ComponentResult;
© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top |